home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 April / CMCD0404.ISO / Software / Complet / emovix / eMovix-0.9.0pre1_Setup.exe / {app} / README < prev    next >
Encoding:
Text File  |  2003-12-26  |  31.6 KB  |  831 lines

  1.  
  2.               eMoviX v0.9.0pre1 <http://movix.sf.net/>
  3.           Author: Roberto De Leo <peggish@users.sf.net>
  4.                  Last update : 26 Dec 2003 
  5.  
  6.   What is it?
  7.   -----------
  8.  
  9.   eMoviX is a tiny Linux CD distribution containing all the software to boot
  10.   from a CD and play automatically every video file localized in the CD root.
  11.   Supported formats are all formats supported by MPlayer, most noticeably
  12.   DivX & XviD but more in general most AVI, MPEG, QuickTime, WMV, ASF, FLI and 
  13.   a few others.
  14.   If you put a subtitles file in the same position with the same name (e.g.
  15.   movie.avi and movie.sub) then the subtitles will be automatically displayed.
  16.  
  17.   In other words, if you put your video file(s) and eMoviX in the same CD then
  18.   you will have inside the CD not only the movie but also all the software
  19.   needed to boot the PC and play the movie, so that you'll be able to play
  20.   the movie in every PC even when no OS (or the wrong one :-) is installed
  21.   (at least as long as that PC hardware is supported by Linux).
  22.  
  23.   Of course you will still able to read the CD and play the movie from any
  24.   other OS, so the only thing you are going to lose are the ~8Mb that the
  25.   eMoviX is going to occupy on the CD.
  26.  
  27.   How is it done?
  28.   ---------------
  29.  
  30.   eMoviX is all made from software already available on the net.
  31.   The main packages on which it is based are:
  32.  
  33.   syslinux v2.08       <syslinux.zytor.com>   to make the CD bootable
  34.   linux kernel v2.4.22 <www.kernel.org>       to hearth of the system :-)
  35.   busybox 1.0pre3      <www.busybox.net>      the system binaries
  36.   mplayer v0.92        <www.mplayerhq.hu>     to play the movies
  37.   alsa 1.0.0rc1        <www.alsa-project.org> as audio cards drivers
  38.  
  39.   This is the first version that is not based on slackware's initrd.gz
  40.   root fs I had started working on more than a year ago.
  41.   The system is now based on the movix-builder mechanism invented
  42.   by Balazs Barany: all binaries are now automatically built inside a 
  43.   User-Mode Linux session based on Debian.
  44.   If you don't know what UML is, go visit the following URLs:
  45.     http://user-mode-linux.sourceforge.net/
  46.     http://usermodelinux.org/
  47.  
  48.   This ingenous mechanism has the following large advantages over the old one:
  49.   1. makes the eMoviX development totally independent on the linux distro  
  50.      people work on
  51.   2. makes extremely easy keeping all packages up-to-date since to rebuild
  52.      the whole system it is needed just to run a few commands
  53.   3. allows Linux users to customize eMoviX for their need in the easiest
  54.      way possible
  55.  
  56.   If you are interested in using the movix-builder system, please read the
  57.   README file online at http://tud.at/bb/download/movix-build/readme .
  58.  
  59.   From there, you can also download the necessary files.
  60.  
  61.   Please note that you need to be an experienced Linux user to be able to use
  62.   the movix-builder system (and generally User Mode Linux). It's a complex
  63.   system, and we can only give limited support so you are almost on your own.
  64.  
  65.   Documentation
  66.   -------------
  67.  
  68.   Up to now I did not have much time to write any doc about all this, so this
  69.   file contains almost all the documentation available. Hopefull will find
  70.   time in the future. A little info/docs are available at the boot prompt on
  71.   every CD produced with eMoviX.
  72.  
  73.   Requirements
  74.   ------------
  75.  
  76.   --> Software:
  77.  
  78.   The only thing you need to use eMoviX is a software package to
  79.   produce the bootable isoimage and one to burn the image on CD.
  80.  
  81.   On both Linux and M$ Window$ you can use mkisofs & cdrecord,
  82.   that you can get from
  83.  
  84.     ftp://ftp.berlios.de/pub/cdrecord/
  85.  
  86.   Working copies of mkisofs.exe and cdrecord.exe for WinXX users are 
  87.   included in the file MoviX_Win32_Script.zip packaged by Christophe 
  88.   Paris and available for download in the usual MoviX download page
  89.  
  90.     http://sourceforge.net/project/showfiles.php?group_id=61561.
  91.  
  92.   The file contain also useful .bat files written by Christophe that
  93.   should make a lot easier using mkisofs and cdrecord to M$ users.
  94.   Many thanks to Christophe for making available these files!
  95.  
  96.   IMPORTANT NOTICE FOR WINDOWS USERS
  97.   There are two new packages that allow window$ users to create eMoviX
  98.   images through a user-friendly GUI:
  99.  
  100.   - eMoviX win32 Setup  by Clovis Sena (csena2k2@users.sf.net)
  101.     This package is downloadable from the usual movix download page.
  102.  
  103.   - MovixISOCreator by Kangur (movixisocreator@o2.pl)
  104.     This package is downloadable from http://www.movixisocreator.prv.pl/
  105.  
  106.   --> Hardware:
  107.  
  108.   CPU
  109.   Only x86 compatible are supported, and only >= i586 
  110.   (you need at the very least a Pentium I 166MHz)
  111.  
  112.   RAM
  113.   According to my tests all eMoviX features work with 36MB of RAM.
  114.   Some feature [e.g. mpeg playback] works even with just 32MB but mileage
  115.   can vary according to your HW and the type of file contained in the CD.
  116.  
  117.   MICE
  118.   You need no mouse with eMoviX.
  119.  
  120.   CONTROLLERS
  121.   All IDE controllers are supported.
  122.   To keep the distro as small as possible only a few widespread SCSI 
  123.   controllers are supported (e.g. Adaptec controllers).
  124.   Please write me an email if your controller seems not to work fine.
  125.  
  126.   VIDEO CARDS
  127.   It is not easy to say on which video cards eMoviX will work.
  128.   Cards brand that are generally known to work are:
  129.  
  130.     Matrox
  131.     Ati
  132.     NVidia
  133.     Intel
  134.     3Dfx
  135.     Sis
  136.     S3
  137.     Trident
  138.     VIA
  139.  
  140.   but it is likely that the majority of video cards will work fine.
  141.   I plan to publish soon on the movix web site a more detailed video cards database,
  142.   so if your video card is not on my list and works with eMoviX please let
  143.   me know and I will add it to the list of cards known to work.
  144.   Same if it does not!
  145.  
  146.   BTW, if you use the "aa" label than eMoviX will work no matter which card
  147.   do you have. Ok, it is ASCII visualization but, what the hell, it works! :-)
  148.  
  149.   VIDEO CARDS WITH TV-OUT
  150.   eMoviX has support for using the TV-out feature of at least some Matrox, ATI,
  151.   S3 Savage, NVidia, SiS and VIA CastleRock video cards.
  152.   
  153.   - ATI: they activate their tv-out automatically if the output is connected
  154.   to the TV when you boot the PC.
  155.  
  156.   - Matrox G400: use the TV boot label.
  157.  
  158.   - Matrox G450 and G550: use the TV boot label. The video will appear on the TV, 
  159.   it needs to be connected to the secondary output of the video card.
  160.  
  161.   - NVidia: use the TV boot label.
  162.  
  163.   - S3 Savage: use the TV boot label. The computer's screen will be blank, all output
  164.   goes to the TV. After the movie ends, you can get back to the computer screen by
  165.   entering "s3switch lcd" or "s3switch crt".
  166.  
  167.   - SiS: this card has been tested only on laptops. Boot with any label and activate
  168.   the TV-out from your keyboard.
  169.  
  170.   - CastleRock: this card TV-out will be automatically activated starting eMoviX
  171.   with the TV-out plug already connected to the TV.
  172.  
  173.   AUDIO CARDS
  174.   eMoviX makes use of the ALSA sound drivers.
  175.   A complete list of all supported cards with detailed info on each of them
  176.   is available form the ALSA home page at
  177.     http://www.alsa-project.org/
  178.  
  179.   ETHERNET CARDS
  180.   Net is not supported by eMoviX.
  181.  
  182.   REMOTES
  183.   Currently supported remotes are:
  184.   Hauppauge TV card remotes
  185.   Hauppauge serial remotes
  186.   Logitech serial remotes
  187.   Pinnacle serial remotes
  188.   You can make use of these remotes by specifying REMOTE=<name> as a boot parameter,
  189.   where <name> can be one of the following:
  190.   'hauppauge' for IR receivers attached to your Hauppauge card,
  191.   'hauppauge2' for the Hauppauge PVR remote control and a receiver at the serial port
  192.   'haupserial' for the old Hauppauge remote control and a receiver at the serial port
  193.   'logitech' for the Logitech Value Infrared Remote Control
  194.   'pctv' for the PCTV Remote and a receiver at the serial port
  195.   'abit' for the AU10 audio card / windvd
  196.  
  197.   If you are interested in supporting more remotes post a message in the movix forums.
  198.  
  199.   For_experts_only:
  200.   Basically you have to add a line in remotes.data. The first entry is the
  201.   boot parameter and is also used for the files lircd.conf.* and lircrc.* which you
  202.   have to create *before* "make install". You do also have to mention these two files
  203.   in Makefile.am and do a make clean and rerun ./configure .
  204.   The second entry is the internal lirc name for the device, you can get a list by
  205.   typing "lircd -H help".
  206.   The third column is the device lircd accesses while running.
  207.   The last column specifies the (pseudo) module name that has to be loaded for lirc.
  208.   See also rc.lirc for internal details.
  209.  
  210.   Supported Audio/Video formats
  211.   -----------------------------
  212.  
  213.   I am not at all an expert in this so I cannot be very precise about this.
  214.   All I know is that you should be able to play most of the DivX/XviD files around
  215.   and more in general most AVI, MPG file, QuickTime, ASF and WMV should be ok.
  216.   About video files, all MP3 and OGG/VORBIS files should play fine.
  217.  
  218.   If you have examples of such files not working with eMoviX please
  219.   let me know.
  220.  
  221.   Installation
  222.   ------------
  223.  
  224.   eMoviX uses the autoconf/automake mechanism, so installing eMoviX is
  225.   as easy as untarring the tarball, cd-ing in the newly created directory 
  226.   and running the standard commands
  227.      ./configure
  228.      make
  229.      make install
  230.   By default the binaries "mkmovixiso", "movix-conf" and "movix-version"
  231.   will be installed in
  232.      /usr/local/bin
  233.   and all eMoviX data files will be copied in
  234.      /usr/local/share/emovix
  235.  
  236.   Or you can install the Debian package available at the usual download area.
  237.  
  238.   If all this does not make any sense to you or if you rather prefer making
  239.   the iso image by hand, just forget what you've just read and read below.
  240.  
  241.   Linux GUIs for eMoviX
  242.   ---------------------
  243.  
  244.   If you are not a CLI lover, there are two GUIs for you:
  245.  
  246.   * MoviXMaker
  247.  
  248.   MoviXMaker (http://savannah.nongnu.org/projects/movixmaker/) is a simple 
  249.   Perl GTK+/Gnome/GladeXML interface created by Pascal Giard 
  250.   <evilynux@users.sf.net> that helps you make, very easily, customized 
  251.   eMoviX/MoviX/MoviX2 disc images.
  252.   
  253.   * K3b
  254.  
  255.   K3b (http://www.k3b.org/) is a very nice KDE GUI for burning CDs with Drag'n'Drop 
  256.   capabilities and much more. Thanks to many users requests, its mantainer Sebastian 
  257.   Trueg decided to support the eMoviX format!
  258.   This means that if you install K3b you'll be able to produce eMoviX CDs simply
  259.   choosing to open a new "eMoviX Project" :-)
  260.  
  261.   You can safely ignore next 3 sections unless you are a 'die-hard' CLI lover 
  262.   like me ;-)
  263.  
  264.   Making a bootable iso image with your audio/video files
  265.   -------------------------------------------------------
  266.  
  267.   DISCLAIMER FOR WINDOWS USERS: as already pointed out above, there are two 
  268.   win32 GUIs for producing eMoviX ISO images, namely:
  269.  
  270.   - eMoviX win32 Setup, by Clovis Sena (csena2k2@users.sf.net)
  271.     This package is downloadable from the usual movix download page
  272.     (is the one with .exe extension ;-)
  273.  
  274.   - MovixISOCreator, by Kangur (movixisocreator@o2.pl)
  275.     This package is downloadable from http://www.movixisocreator.prv.pl/
  276.  
  277.   If you like the command line, you can use the Christophe Paris package
  278.   MoviX_Win32_Script.zip, available for download in the usual MoviX download 
  279.   page, and follow the "Old style" instructions below, or install cygwin
  280.   (http://cygwin.redhat.com/) and follow the "New style" instructions.
  281.  
  282.   *** New style [not good for winXX users unless you have installed cygwin]
  283.  
  284.   To make as easy as possible the creation of the bootable iso image,
  285.   the perl script "mkmovixiso" is provided together with the package.
  286.   The typical thing you have to type to produce an iso image containing the
  287.   files "file1" and "file2" and all files in the directory "dir" is something
  288.   like
  289.  
  290.      mkmovixiso -t "My title" -o /tmp/movix.iso file1 file2 dir
  291.  
  292.   Keep in mind that you may want to add also some playlist to the CD, in case
  293.   you have more than one file and you want them played in some particular order.
  294.   For more info read carefully the "Playlists" section below.
  295.  
  296.   To know more about mkmovixiso options try "mkmovixiso -h".
  297.  
  298.   If you use always the same output file or same language or like to add
  299.   always the same extra options, you can avoid writing them explicitly
  300.   every time you run mkmovixiso creating a .mkmovixisorc file in your home dir.
  301.   Here is an example 
  302.   [WARNING: these are more or less random setting, use your own ones!!!]:
  303.  
  304. # <--------- .mkmovixisorc sample
  305.  
  306. # my .mkmovixisorc file
  307. # all lines starting by # are comments!
  308.  
  309. # default output file location
  310. output-file=/tmp/movix.iso
  311.  
  312. # default boot label
  313. boot-label=MoviX
  314.  
  315. # default font set
  316. subtitleFonts=polish
  317.  
  318. # extra options for mkisofs
  319. extra-mkisofs-options=-J
  320.  
  321. ### Options to be passed to MPlayer
  322.  
  323. # extra options for mplayer
  324. extra-mplayer-options=-double -aspect 4:3 
  325.  
  326. # options you want to be sure won't be used by mplayer
  327. unwanted-mplayer-options=-fs -zoom
  328.  
  329. # repeat the playback 5 times [0 = repeat for ever]
  330. loop=5
  331.  
  332. # do not enforce DMA usage
  333. #[use it only if your system hangs during the boot]
  334. dma=n
  335.  
  336. # play all files in random order
  337. random=y
  338.  
  339. # reboot after playback is over
  340. reboot=y
  341.  
  342. # turn off the PC after playback is over
  343. # shut=y
  344.  
  345. # eject after playback is over
  346. eject=y
  347.  
  348. # delete temporary directory
  349. auto-delete=y
  350.  
  351. # ---------> end of .mkmovixisorc sample
  352.  
  353.   No other options are available till now for the .movixrc
  354.  
  355.   *** Old style [for winXX users willing to use mkisofs without installing cygwin]
  356.  
  357.   If you like better the good old way do something similar to this:
  358.  
  359.   0. make somewhere, e.g. inside the "utils" folder",  a new directory,
  360.      say you call it "movix";
  361.   1. copy the folders src/isolinux and src/movix in the newly created
  362.      "movix" folder [just to avoid misunderstandings, the new "movix" folder
  363.      and src/movix are _not_ the same folder and the second won't appear anymore
  364.      in this section...];
  365.   2. if you have subtitles and wanna see them, create a folder called "mplayer"
  366.      inside "movix", create a folder "font" inside "mplayer" and copy inside
  367.      it your favorite character set from mplayer-fonts [inside "font" there
  368.      should be at this point a few files with extension .raw an a single file
  369.      called font.desc];
  370.   3. copy all the audio/video files you want in the "movix" folder;
  371.   4. run "sh mkmovixiso.sh" if you are on unix and "mkmvxiso.bat" if you are
  372.      on winXX; your bootable iso image will be created in "\tmp\movix.iso"
  373.      and "c:\temp\movix.iso" respectively.
  374.      Remember to edit the _-V "Film"_ string inside the script if you want to
  375.      give a better title to your CD!
  376.  
  377.   Please let me know if you find any mistake in this algorithm :-)
  378.  
  379.   *** Don't wanna use mkisofs!
  380.  
  381.   Window$ users hating mkisofs can still produce bootable eMoviX
  382.   CDs with the following method introduced to me by the very
  383.   inventive Hakan Atac:
  384.  
  385.   0. download the eMoviX bootable floppy image;
  386.   1. start Nero :-)
  387.   2. close the wizard (it has no bootable option);
  388.   3. select CD-ROM (boot) from left selection area,
  389.      it takes you to the boot section;
  390.   4. select as disk image the floppy image you downloaded
  391.      in step 0;
  392.   5. in expert settings, set "Kind of Emulation" to "No emulation";
  393.   6. put the "isolinux" directory in the CD root.
  394.      IMPORTANT: if you want to use subtitles you must create in the CD root
  395.      also a "mplayer/font" dir (font is a subdir of mplayer) and put your
  396.      favorite fontset inside it. For example, for turkish fonts you must
  397.      put inside the "mplayer/font" folder all files you find in the
  398.      "mplayer-fonts/turkish/" folder of the eMoviX package;
  399.   7. put all your audio/video files in the CD root [don't put them in any
  400.      subdirectory!];
  401.   8. if you want eMoviX to play your files in any particular order, put one
  402.      or more playlists in the "movix" folder. By default eMoviX will play
  403.      the one named "movix" (if any).
  404.   9. burn the CD!
  405.  
  406.   Thanks a lot to Hakan Atac for providing this nice way to build bootable
  407.   CDs with Nero!
  408.  
  409.   MultiSession
  410.   ------------
  411.  
  412.   To learn how to add sessions to an eMoviX CD you can read the docs on
  413.   http://advancemame.sourceforge.net/doc-advcd.html
  414.   in sections 5-7.
  415.   WARNING: making an eMoviX multisession CD with Nero is tricky because
  416.   Nero is not aware of the Rock-Ridge CD format, so please *read* the
  417.   sections above.
  418.   NOTE: a user suggested using Winimage to add files to a bootable ISO file
  419.   under WinXX. I had no time to test this, so if you try it please let
  420.   me know if it works!
  421.  
  422.   Usage
  423.   -----
  424.  
  425.   Once you have your iso image you can burn it over a CD with something
  426.   like
  427.  
  428.      cdrecord dev=0,0 -v -eject /tmp/movix.iso
  429.  
  430.   or just use Nero or any package able to burn iso images on CDs.
  431.  
  432.   Leave the newly created CD in the CD-ROM drive and reboot your PC: if
  433.   everything went fine your PC will boot from the CD and after a few seconds
  434.   the mplayer copy contained in eMoviX will start playing all of your files.
  435.  
  436.   Boot Labels
  437.   -----------
  438.  
  439.   There are a lot of video cards out there and a lot of mplayer video drivers
  440.   and not necessarily all of their combinations work well together.
  441.  
  442.   The movix.pl script tries to determine automatically the best options for you,
  443.   so that you don't need in general to enter anything at the boot prompt.
  444.  
  445.   But in case you are not satisfied with the playback video quality there
  446.   are a few extra boot labels you can try to force eMoviX to use a particular
  447.   driver:
  448.  
  449.      Label       Comment
  450.  
  451.      MoviX    -  The default label causes the movix script to choose
  452.    (default)     automagically the best mplayer driver for your card.
  453.  
  454.       sdl     -  Very good subtitles rendering but not the best video quality.
  455.  
  456.      vesa     -  The "vesa" driver should work for most cards.
  457.  
  458.      vesaFB   -  Use the generic vesa FrameBuffer driver (800x600).
  459.  
  460.     vesaFB640, vesaFB800, vesaFB1024, vesaFB1280, vesaFB1400
  461.               -  vesaFB labels for the following resolutions:
  462.                  640x480 800x600 1024x768 1280x1024 1400x1050
  463.  
  464.       FB      -  Use the specific FB driver for yr card (if any).
  465.  
  466.       aa      -  Watch your videos in ASCII format! :-)
  467.  
  468.      aa1024   -  Watch your videos in ASCII format at a 1024x768 resolution.
  469.      aa1280   -  Watch your videos in ASCII format at a 1280x1024 resolution.
  470.                  (these last two requires a CPU >= 1GHz)
  471.  
  472.       TV      -  Initialize the applications [if any] needed to activate
  473.                  the TV-out of your card.
  474.  
  475.     NVidiaTV  -  Try this label if the TV-out of your NVidia card does 
  476.                  not work.
  477.  
  478.   There are also two extra labels that can be useful too when you
  479.   forget an eMoviX CD in your drive:
  480.  
  481.     hd    - forget the CD and boot from the HD
  482.     floppy    - forget the CD and boot from the Floppy
  483.  
  484.   Thanks a lot to Christophe Paris for this nice suggestion,
  485.   I use it many times a day!
  486.  
  487.   Boot Arguments
  488.   --------------
  489.  
  490.   You can also provide at boot time a few options that will be automagically
  491.   passed to the movix.pl script to modify its behaviour:
  492.  
  493.             Boot Args  Values     Effect
  494.  
  495.               SLOW       y,n      By default movix slows down your CD-ROM drives
  496.                                   to decrease their noise, but sometimes this messes
  497.                                   them up. If your CD drive seems to behave in some
  498.                                   strange way try using this option.
  499.  
  500.               ACCEL      sw,no    Force software or no rescaling. If your playback
  501.                                   appears to be very slow you can try "ACCEL=no"
  502.                                   to make it smoother [but your movie won't be rescaled
  503.                   to fullscreen!].
  504.  
  505.               VO_DRIVER  <driver> Force vo driver (read mplayer DOCS first!).
  506.  
  507.               MP_OPTIONS <opts>   Add mplayer options (same as above!).
  508.  
  509.               LIST       <list>   Use "list" as default playlist.
  510.  
  511.               DMA        y,n      Use "DMA=n" if your system hangs at boot time
  512.                   trying to access your CD drive.
  513.  
  514.               SHUT       y,n      Power off PC after playing all CD files.
  515.                   This is especially useful if you are likely to
  516.                   fall asleep before the end of the playback :-)
  517.  
  518.               REBOOT     y,n      Reboot PC after playing all CD files.
  519.  
  520.               LOOP       <N>      Loops playback n times. Setting "LOOP=0"
  521.                   let mplayer playing your files for ever.
  522.  
  523.               RANDOM     y,n      Play all the CD files in random order.
  524.  
  525.               REGION     <region> Either one of NTSC, NTSC-J, PAL, PAL-B,
  526.                                   PAL-M, PAL-NC, PAL-60, PAL-M60 or SECAM.
  527.                                   For your TV-Out to work properly,
  528.                                   your video card needs to know what mode uses
  529.                                   your TV (ATI cards don't need this).
  530.  
  531.               AUDIO     <N>       Audio card selection (if you have more than one)
  532.                                   0 for the "first" card, 1 for the "second" etc.
  533.                                   The order in which the audio cards are detected
  534.                                   by eMoviX is somewhat arbitrary, so you might 
  535.                                   need to try 0 and 1. 
  536.  
  537.           SCSI     <module>   Force eMoviX to load the SCSI module.o module
  538.                   (e.g. "SCSI=tmscsim")
  539.  
  540.               REMOTE   <model>    Either one of: hauppauge, haupserial, logitech
  541.                                   pctv, hauppauge2, abit
  542.  
  543.               DXR3      n         Don't use your DXR3/H+ card (if any)
  544.  
  545.   Example: if you like the standard boot label but you want to play your
  546.   "sleepy.asx" playlist and you want your PC to shut down after the playlist's
  547.   end (probably because you shut down way before that) and you don't want to
  548.   slow down your CD-ROM because you like that buzzing background, then you
  549.   should use the folowing boot string:
  550.  
  551.     boot: MoviX LIST=sleepy.asx SLOW=n SHUT=y
  552.  
  553.   FOR EXPERTS ONLY:
  554.   You can create your own customized boot label for every PC you know in the file
  555.   isolinux.cfg . This way you do not have to type the name of your remote control
  556.   or any other special setting over and over again.
  557.  
  558.   How to play QuickTime/ASF/WMV/RP files
  559.   --------------------------------------
  560.  
  561.   To play these kinds of files files MPlayer needs a few special DLL. 
  562.   They are not included in the eMoviX package to keep it slim, so you have to
  563.   download them by yourself at the following addresses:
  564.  
  565.       - Win32 codecs (asf,wmv)
  566.         http://www1.mplayerhq.hu/MPlayer/releases/codecs/win32codecs.tar.bz2
  567.       - QuickTime6 DLLs
  568.         http://www1.mplayerhq.hu/MPlayer/releases/codecs/qt6dlls.tar.bz2
  569.       - RealPlayer9 codecs
  570.         http://www1.mplayerhq.hu/MPlayer/releases/codecs/rp9codecs.tar.bz2
  571.       - RealPlayer Win32 codecs
  572.         http://www1.mplayerhq.hu/MPlayer/releases/codecs/rp9win32codecs.tar.bz2
  573.       - XAnim DLLs
  574.         http://www1.mplayerhq.hu/MPlayer/releases/codecs/xanimdlls.tar.bz2
  575.  
  576.   To make eMoviX able to play these kind of files follow the following instructions:
  577.  
  578.   1. download the DLL files you need
  579.  
  580.   2. create a directory "codecs" inside the $prefix/share/emovix/ directory
  581.      (by default $prefix is /usr/local/)
  582.  
  583.   3. put the bz2 archives inside the newly created "codecs" dir; do *not* unpack the
  584.      tarball, eMoviX itself will take care of it
  585.  
  586.   4. every time you put, say, QuickTime files in an eMoviX CD, add the "--hasQT" option to
  587.      the mkmovixiso line you normally use.
  588.      Find out about all "--hasXX" options with "mkmovixiso -h"
  589.  
  590.   WARNING ABOUT QUICKTIME FILES: for a MPlayer bug, mplayer will crash when trying to play
  591.   its second QuickTime file, so till this bug will be fixed it does not make much sense 
  592.   adding more than one QuickTime file to an eMoviX CD.
  593.  
  594.   Mplayer Menu
  595.   ------------
  596.  
  597.   You can easily use the MPlayer "menu" feature to "navigate" through
  598.   your videos selection and/or to play any kind of media!
  599.   Just wait for mplayer to start and press the key "m" to activate the menu.
  600.  
  601.   The list of the other active keys for the mplayer is available in the 
  602.   "Menu Manual" entry od the menu or on the mplayer site.
  603.   The list of the most important keys is also available on every eMoviX CD
  604.   when the splash-page logo appears.
  605.  
  606.   How to play other media after the playback is over without rebooting
  607.   --------------------------------------------------------------------
  608.  
  609.   After the playback is over you will have access to the MPlayer menu,
  610.   so you can play whatever you want from it  :-)
  611.  
  612.   If you want to play *all* files contained in a CD, then you may find
  613.   useful using the "Play -> CD" menu  ;-)
  614.  
  615.   If you are a CLI lover, then you may go back to the shell selecting
  616.   "Exit -> Shell Prompt".
  617.   The following commands are available for playback:
  618.  
  619.     movix   (to play a CD with audio/video files inside)
  620.     dvd N   (where N is usually 1 or 2)
  621.     dvd     (automatically plays the longest DVD track)
  622.     vcd N   (where N is usually 1 or 2)
  623.     acd
  624.     mcd
  625.  
  626.   *** IMPORTANT DVD NEWS ***
  627.   Because of the DeCSS legal problems, this eMoviX version cannot read encrypted 
  628.   DVDs unless *you* add *by your own* the libdvdcss.so library to the distro.
  629.  
  630.   The libdvdcss library makes use of the DeCSS algorithm, that has been
  631.   declared *illegal* in some country (e.g. USA and Germany), so before adding it
  632.   I suggest you to make sure it is ok to use it in your country. 
  633.  
  634.   Because of the extremely unclear status of the legal matters about DeCSS I can't
  635.   even provide a link for those who legitimally can make use of it. 
  636.   Nevertheless all you should do is going in your favorite search engine, look for 
  637.   the package named libdvdcss-1.2.6-1.i386.rpm and copy that package in your
  638.   $prefix/share/emovix/movix directory (or in src/movix if you are building eMoviX CDs 
  639.   without using the mkmovixiso script).
  640.  
  641.   Once the library is in you eMoviX installation, remember to add "-css" to the 
  642.   mkmovixiso options for all eMoviX CDs that you want to make able to read 
  643.   encrypted DVDs.
  644.   **********************
  645.  
  646.   To get a much more powerful interface to MPlayer go back at the MoviX
  647.   web site and download the last MoviX or MoviX2 version!
  648.  
  649.   What to do if audio is too low or absent
  650.   ----------------------------------------
  651.  
  652.   If the audio is too low or absent even after maximizing it from mplayer 
  653.   then you can try the following:
  654.   stop the movie, change console with ALT-F2, change the volume
  655.   with alsamixer, go back to the original console with ALT-F1 and
  656.   start back the playback with the "movix" command.
  657.   Note: you *cannot* do this while the movie is playing!
  658.  
  659.   Playlists
  660.   ---------
  661.  
  662.   Since version 0.6 eMoviX supports playlists!
  663.   The supported formats are: .asx .m3u .pls .txt .list
  664.  
  665.   E.g. if you have a file "My Video.avi" and "My Audio.mp3" you
  666.   may write the following lists:
  667.  
  668.   1. movix.asx
  669.  
  670.   that will look like:
  671.  
  672.   <asx version = "3.0">
  673.    <title>My List</title>
  674.    <entry>
  675.      <ref href = "/cdrom/My Video.avi"/>
  676.    </entry>
  677.    <entry>
  678.      <ref href = "/cdrom/My Audio.mp3"/>
  679.    </entry>
  680.   </asx>
  681.   
  682.   2. movix.list or movix.txt
  683.  
  684.   that will look like:
  685.  
  686.   /cdrom/My Video.avi
  687.   /cdrom/My Audio.mp3
  688.  
  689.   Don't know much about pls or m3u formats but I know that they work,
  690.   at least in some case :-)
  691.  
  692.   eMoviX by default looks in the CD root for "movix.asx" or "movix.list"
  693.   or similar.
  694.   If none of them is available, then files should be played in alphabetic
  695.   order. 
  696.   If you like to have more than a playlist you can use other names and activate
  697.   the other ones booting the CD with the LIST parameter.
  698.   E.g if you have two playlists named "movix.list" and "alt.list" and want to
  699.   use the second, then boot the CD in the following way:
  700.  
  701.      boot: MoviX LIST=alt.list
  702.  
  703.   NOTE: keep in mind that the new mplayer "menu" feature allows you to open
  704.   a new playlist (or even to move from file) without having to reboot!
  705.  
  706.   Internationalization
  707.   --------------------
  708.  
  709.   NOTE: That can be selected using K3b, MoviXMaker or MoviXISOCreator.
  710.  
  711.   eMoviX contains translations in several languages for the boot-messages.
  712.   To get a complete list use "mkmovixiso -h".
  713.   To use boot messages in a language different from english use the
  714.   "-lang <lang>" option of mkmovixiso [get details with "mkmovixiso -h"].
  715.  
  716.   International keyboard support
  717.   ------------------------------
  718.  
  719.   NOTE: That can be selected using K3b, MoviXMaker or MoviXISOCreator.
  720.  
  721.   On many non-English keyboards like German and Hungarian the characters needed
  722.   by eMoviX are hard to type and not where you would expect them. (IBM
  723.   compatible PCs and eMoviX use the US English keyboard layout by default.)
  724.  
  725.   You can use the --keyboard=<language> switch to change the keyboard layout
  726.   both for the boot command line and for the Linux shell.
  727.  
  728.   Example: "mkmovixiso --keyboard=de" will create an eMoviX CD that uses the
  729.   German keyboard layout.
  730.  
  731.   Supported font sets
  732.   -------------------
  733.  
  734.   NOTE: That can be selected using K3b, MoviXMaker or MoviXISOCreator.
  735.  
  736.   The eMoviX package contains the following mplayer fonts: 
  737.     centralEU-cp1250, centralEU-iso-8859-2, czech, cyrillic, greek, hebrew, polish, 
  738.     russian and turkish.
  739.   All these packages support latin characters (iso-8859-1) plus their specific characters.
  740.  
  741.   eMoviX also contains the following TrueType fonts:
  742.     FreeFonts, VeraFonts
  743.  
  744.   Don't even ask about adding the standard Microsoft TrueType fonts such as Arial, 
  745.   Courier and so on: they are free of charge but they are not under any kind of 
  746.   "Open Source" license  :-(
  747.   Nevertheless, you can add them very easily to your own eMoviX installation just copying
  748.   the ttf files from your c:\windows\fonts\ directory (if any ;-) to your
  749.   $prefix/share/emovix/mplayer-fonts/ directory or getting the fonts directly from the
  750.     http://sourceforge.net/projects/corefonts/
  751.   page.
  752.   Of course all this under your own responsibility ;-)
  753.   Thanks a lot to Balazs Barany for pointing out this little copyright problem to me! :-)
  754.  
  755.   By default the FreeSerifBoldItalic font is added to the iso image.
  756.   To have no fonts included add the -noSub option to the "mkmovixiso" command.
  757.   See "mkmovixiso -h" to see how to choose a different font set.
  758.  
  759.   In general you'll write something like
  760.  
  761.      mkmovixiso -a filename -t "My title" -sub=greek -o /tmp/movix.iso
  762.  
  763.   All mplayer fonts packages were extracted from 
  764.  
  765.     ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/
  766.  
  767.   except for the polish fonts (sent me by Krzysztof Kajkowski) and hebrew 
  768.   fonts (sent me by Pavel Bibergal).
  769.  
  770.   Here is where the included True Type fonts come from:
  771.  
  772.      FreeFonts  -  http://www.nongnu.org/freefont/
  773.      VeraFonts    -  http://gnome.org/fonts/
  774.  
  775.   For space reasons I did not include them all. If you want more choice, go get them
  776.   and add all you want!
  777.  
  778.   Chinese Fonts
  779.   -------------
  780.  
  781.   Chinese fonts are not included in the package simply because the size of a set of
  782.   Chinese characters is ~50% of the whole eMoviX package :-)
  783.   If you want to add chinese characters support, you can either follow the 
  784.   instructions at 
  785.  
  786.     http://sourceforge.net/forum/forum.php?thread_id=878378&forum_id=207427
  787.  
  788.   or download the true type chinese fonts at
  789.  
  790.     http://www.arphic.com.tw/free/free.htm
  791.  
  792.   Korean Fonts
  793.   ------------
  794.  
  795.   Same problem as with Chinese fonts.
  796.   If you need them, get the package from 
  797.  
  798.      ftp://ftp.netbsd.org/pub/NetBSD/packages/1.6/i386/All/baekmuk-ttf-2.0.tgz
  799.  
  800.   Debugging
  801.   ---------
  802.  
  803.   For debugging purposes, after a nice suggestion by Jose' M. Fandinho,
  804.   I added to eMoviX a script that will put on a floppy the following info:
  805.     1. output of dmesg
  806.     2. /proc/pci
  807.     3. movix script logs
  808.     4. settings of all cd-rom on the machine
  809.  
  810.   To run the script just put an empty floppy in the floppy drive, write
  811.   "debug" and press ENTER.
  812.   All debug info will be put in the floppy inside a single file named
  813.   bugreport.txt .
  814.  
  815.   Kernel & MPlayer configuration
  816.   -----------------------------
  817.  
  818.   You will find the config files for the current eMoviX mplayer and vmlinuz
  819.   in the "config" dir of this package.
  820.  
  821.   Acknowledgments
  822.   ---------------
  823.  
  824.   I want to thank the great guys at www.scriptamanent.it for making the
  825.   logo for the eMoviX project.
  826.   I also want to thanks my friend Andrea Assorgia for all his encouragements
  827.   and good advices about making eMoviX and for actually having suggested
  828.   the name of the project. Special thanks go to my brother Vincenzo that
  829.   bought me a very fast CD burner speeding up a lot the development of this
  830.   package! :-)
  831.